html 模式发布报表

润乾报表提供了tag标签供程序员发布报表，减轻代码编写的工作量。

本章重点讲解<report:html/>的使用。

发布基本报表

◆ 背景说明

  通过tag发布报表，最简单的情况下只需要指定报表模板名。为了满足不同层次的需要，润乾报表tag还支持definebean的方式发布报表、支持传递context对象，便于用户自定义数据源、自定义参数等。

 

◆ 示例代码1：file方式发布

<report:html name="report1"

      srcType="file"

    reportFileName="api/wangge.rpx"

/>

◆ 示例代码2：defineBean方式发布

<% 

//取得报表真实路径

String reportPath = request.getRealPath("WEB-INF/reportFiles/api/wangge.rpx");  ReportDefine rd = (ReportDefine)ReportUtils.read(reportPath);

request.setAttribute("reportDefine",rd); //把ReportDefine对象在request中保存

%>

<report:html name="report1"

    srcType="defineBean"

    beanName="reportDefine"

    exceptionPage="myError.jsp"  //错误提示页面

  />

示例代码3：reportBean方式发布

<% 

  //取得报表真实路径

  String reportPath = request.getRealPath("WEB-INF/reportFiles/api/wangge.rpx");

ReportDefine rd = (ReportDefine)ReportUtils.read(reportPath);

  Context cxt = new Context(); 

//.......................//其它辅助代码，例如往报表引擎传递参数，传递数据库连接参数等，见后面的介绍

Engine engine = new Engine(rd, cxt);  //构造报表引擎

IReport iReport = engine.calc();  //运算报表

request.setAttribute("report", iReport); //把IReport对象在request中保存

%> 

<report:html name="report1"

      srcType="reportBean"

      beanName="report"

      exceptionPage="myError.jsp"  //错误提示页面

  />

◆ 示例代码4：自定义context后传递给tag去发布

<%

  ……

  Context context = new Context();

  ……  //利用context，可以传递参数，可以指定数据源、数据库连接工厂等

  request.setAttribute( “myContext”, context );

%>

<report:html ……..

  contextName=”myContext”

/>

 

◆ 示例代码5：错误提示页面

 

错误提示页面,是指当程序发布错误时,转跳到一个页面,来人性化的展现错误,具体到报表中,我们在tag标签里提供了exceptionPage属性来指定转跳页面.

<report:html ......

    exceptionPage="myError.jsp"  //错误提示页面

  />

 

在转跳页面中，通过如下代码获取掷出的异常信息:

<%

  Exception e = ( Exception ) request.getAttribute( "exception" );

  out.println( "<h1>错误信息：</h1><div style='color:red'>" + e.getMessage() + "</div>" );

%>

 

◆ 参考文件：

1.1.1.a.jsp，1.1.1.b.jsp，1.1.1.c.jsp

 

参数

◆ 缺省参数输入页面—1.1.2.a.jsp

为了方便用户快速体验报表的功能，当用户的关注点不在于参数录入页面而在于报表时，润乾报表的tag标签提供了generateParamForm属性，只要置为yes就可以自动生成参数录入表单，方便用户快速体验报表。

<report:html name="report1"

  ......

  generateParamForm="yes"

  ......

/>

 

◆ 参数模板—1.1.2.b.jsp

用润乾报表设计的参数模板，需要利用参数模板的tag进行发布，其自动与结果页面的报表关联。因此，比较简单的做法是把参数模板tag和结果报表tag写到一个页面里。如下所示：

 

<report:param name="form1" paramFileName="api/wangge_arg.rpx" />  //参数模板tag

<report:html name="report1"  //结果报表tag

      srcType="file"

      reportFileName="api/wangge.rpx"

      generateParamForm="no"

needImportEasyui="no"

    />

注意：

缺省情况下每个tag标签都会引入一次Easyui样式。如上述jsp 所示，包含两个tag标签，因此默认就会引入两次Easyui样式，引入多次Easyui样式则会出现编辑控件显示不正常的现象。具体关于needImportEasyui属性的使用可参考《润乾报表V2018应用开发手册》文档所示。

 

◆ 自定义参数输入—1.1.2.c.jsp

如果用户自己定义参数输入页面，那么集成流程包括：设计参数页面——〉在接收页面中写代码接收参数——〉在接收页面里把参数拼成串传给tag

//用户自定义的参数输入页面

<FORM name="form1" action="#">   

    尊称：<INPUT type="text" name="appellation">

<input type="submit" value="查询">

</FORM>

//接收页面代码

<%  //获取由参数表单传递的值

    request.setCharacterEncoding("UTF-8");

    String param = "appellation="+request.getParameter("appellation");

%>

//注:参数串param的格式是:paramName=paramValue;paramName2=paramValue2……

<report:html name="report1"

      srcType="file"

      reportFileName="api/wangge.rpx"

      generateParamForm="no"

      params="<%=param%>"    //将拼好的参数串传给tag

      exceptionPage="myError.jsp"

  />

 

◆ 在Jsp中引用参数模板提交的参数－1.1.2.d.jsp

 

参数模板提交的参数，保存在报表系统的参数池中，并没有存在request里，因此如果使用参数模板，要在结果页面里引用参数值，必须在报表的参数池中读取，而不应该从request里获得。

报表提供了两种从参数池中读取参数模板提交的参数值的方法，具体如下所示：

方法一：

<% 

  String reportParamsId=request.getParameter("reportParamsId");  //取得参数缓存的标识号

  //从参数缓存池中取得的参数保存于一个Hashtable中

  Hashtable params = null;

  if(!"".equals(reportParamsId) && reportParamsId != null){

    params = com.raqsoft.report.view.ParamsPool.get( reportParamsId );

  }

  //接下来我们以参数名为key，直接从Hashtable中取参数模板中的传递的参数值

  String paramValue = (String) params.get("appellation");

  out.println("取得的参数值是："+paramValue);

%>

方法二：

通过调用ReportUtils工具类中的getReportParamValue方法获取参数值

<% 

  //通过传递参数名和request请求获取参数值

  String paramValue=(String)com.raqsoft.report.util.ReportUtils.getReportParamValue(request, "appellation");

  out.println("appellation参数取得的参数值是："+paramValue);

%>

◆参数表单提交回调js函数－1.1.2.g.jsp

 

参数表单提交后通过callback回调js函数，当用户提供此函数后，表单采用ajax的方式提交，不刷新页面，系统将resultPage的内容作为参数去调用callback函数。如下所示：

1.1.2.g.jsp：

<script language=javascript>

  function showReports(html){

  $("#reportDiv").html(html);

  } 

</script>

…..

<report:param name="form1" paramFileName=" api/call_arg.rpx "

needSubmit="no"

  callback="showReports"

  resultPage="/jsp/1.1.2.h.jsp?rpx= api/call.rpx"

  params="<%=param.toString()%>"

  />

<div id="reportDiv">

<report:html name="report1" reportFileName="api/call.rpx "

  funcBarLocation="top"

  needPageMark="yes"

  generateParamForm="no"

  params="<%=param.toString()%>"

  exceptionPage=" myError.jsp"

  appletJarName="raqsoftReportApplet.jar"

needImportEasyui="no"

  />

</div>

1.1.2.h.jsp：

<report:html name="report1" reportFileName="api/call.rpx"

    funcBarLocation="top"

    needPageMark="no"

    generateParamForm="no"

    params="<%=param.toString()%>"

    exceptionPage=" myError.jsp"

    appletJarName="raqsoftReportApplet.jar"

needImportEasyui="no"

    />

外观控制

 

◆ 利用tag属性改变按钮风格

<report:html name="report1"

    srcType="file"

    funcBarLocation="top"    //功能条的位置

    reportFileName="api/wangge.rpx"

    separator="|"        //功能按钮的分隔符

    funcBarFontFace="黑体"  //功能按钮的字体

    funcBarFontColor="red"   //功能按钮上的文字颜色

funcBarFontSize="12"    //功能按钮的字号

functionBarColor="white"  //功能按钮的背景色

    />

◆ 传入按钮的html语法

<%  //自定义图片按钮

  String appmap = request.getContextPath();

  String printImage = "<img src='" + appmap + "/images/print.gif' border=no >";    //打印

  String excelImage = "<img src='" + appmap + "/images/excel.gif' border=no >";    //导出Excel

  String pdfImage = "<img src='" + appmap + "/images/pdf.gif' border=no >";    //导出PDF 

  String firstPageImage = "<img src='" + appmap + "/images/firstpage.gif' border=no >";  //最前页

  String lastPageImage = "<img src='" + appmap + "/images/lastpage.gif' border=no >";  //最后页

  String nextPageImage = "<img src='" + appmap + "/images/nextpage.gif' border=no >";  //下一页

  String prevPageImage = "<img src='" + appmap + "/images/prevpage.gif' border=no >";  //上一页

%>

<report:html name="report1"

    srcType="file"

    reportFileName="api/wangge.rpx"

    printLabel="<%= printImage %>"

excelLabel="<%= excelImage %>"

pdfLabel="<%= pdfImage %>"

firstPageLabel="<%=firstPageImag%>"

prevPageLabel="<%= prevPageImage %>"

nextPageLabel="<%= nextPageImage %>"

lastPageLabel="<%= lastPageImage %>"

    />

◆ 自己设计按钮，调用js方法

 

//自定义图片按钮

<% 

  String appmap = request.getContextPath();

  String excelImage = "<img src='" + appmap + "/images/excel.gif' border=no >";//导出Excel

  String pdfImage = "<img src='" + appmap + "/images/pdf.gif' border=no >";//导出PDF

  String wordImage = "<img src='" + appmap + "/images/word.gif' border=no >";//导出word

  String textImage = "<img src='" + appmap + "/images/text.gif' border=no >";//导出text

  String mhtImage = "<img src='" + appmap + "/images/mht.gif' border=no >";//导出mht

 

  String printImage = "<img src='" + appmap + "/images/print.gif' border=no >";//预览打印

  String directprintImage = "<img src='" + appmap + "/images/directprint.gif' border=no >";//直接打印

  String flashprintImage = "<img src='" + appmap + "/images/flashprint.gif' border=no >";//flash预览打印

  String directflashprintImage = "<img src='" + appmap + "/images/directflashprint.gif' border=no >";//flash直接打印

  String pdfprintImage = "<img src='" + appmap + "/images/pdfprint.gif' border=no >";//pdf预览打印

  String directpdfprintImage = "<img src='" + appmap + "/images/directpdfprint.gif' border=no >";//pdf直接打印

 

  String firstPageImage = "<img src='" + appmap + "/images/firstpage.gif' border=no >";//最前页

  String lastPageImage = "<img src='" + appmap + "/images/lastpage.gif' border=no >";//最后页

  String nextPageImage = "<img src='" + appmap + "/images/nextpage.gif' border=no >";//下一页

  String prevPageImage = "<img src='" + appmap + "/images/prevpage.gif' border=no >";//上一页

%>

<table width="100%">

<tr ><td style="font-size:12px" >

    <a href="#" title="预览打印" onClick="printReport('report1');return false;"><%=printImage%></a>

    <a href="#" title="直接打印" onClick="directPrintReort('report1');return false;"><%=directprintImage%></a>

    <a href="#" title="flash预览打印" onClick="flashPrintReport('report1');return false;"><%=flashprintImage%></a>

    <a href="#" title="flash直接打印" onClick="directFlashPrintReport('report1');return false;"><%=directflashprintImage%></a>

    <a href="#" title="pdf预览打印" onClick="pdfPrintReport('report1');return false;"><%=pdfprintImage%></a>

    <a href="#" title="pdf直接打印" onClick="directPdfPrintReport('report1');return false;"><%=directpdfprintImage%></a>

    <a href="#" onClick="exportExcel('report1');return false;"><%=excelImage%></a>

    <a href="#" onClick="exportPdf('report1');return false;"><%=pdfImage%></a>

    <a href="#" onClick="exportWord('report1');return false;"><%=wordImage%></a>

    <a href="#" onClick="exportText('report1');return false;"><%=textImage%></a>

    <a href="#" onClick="exportMht('report1');return false;"><%=mhtImage%></a> 

    <a href="#" onClick="try{toPage('report1',1);}catch(e){}return false;"> <%=firstPageImage%> </a>

    <a href="#" onClick="try{prevPage('report1');}catch(e){}return false;"> <%=prevPageImage%> </a>

    <a href="#" onClick="try{nextPage('report1');}catch(e){}return false;"> <%=nextPageImage%> </a>

    <a href="#" onClick="try{toPage('report1',getPageCount('report1'));}catch(e){}return false;"> <%=lastPageImage%> </a>

    </td>

  </tr>

</table>

 

◆ 用户自定义功能条

用户可能在报表界面中增加自己的功能按钮，而这些功能按钮如何与tag生成的按钮统一摆放呢？此时可以利用tag的userFuncBarElements属性。

<report:html name="report1"

......

userFuncBarElements="<table><tr><td><a href='#' onClick='test()'>测试</a></td></tr></table>"

  />

◆ 超链接显示风格

报表中经常用到超链接，对于有超链接的单元格，其外观是按照设计时单元格的外观还是自动变成蓝色+下划线？润乾报表的tag提供了属性配置：

<report:html name="report1"

......

needLinkStyle="yes"

  />

◆ 参考文件：

  1.1.3.jsp

大数据量报表打印

◆ 背景说明

报表的打印一般都是基于客户端打印，对于一些大数据量报表来说，一次性将所有数据从服务器端传输到打印机，有可能出现内存溢出，为了避免这种情况，报表采取每5页为一个打印单位发送给打印机，这5页打印完后就将从内存中清除，然后循环，直至打印完成。

◆ 示例代码

1.修改WEB-INF\web.xml。将以下代码添加到web.xml中。

  <servlet>

  <servlet-name>com.raqsoft.report.view.PagedPrint</servlet-name>

  <servlet-class>com.raqsoft.report.view.PagedPrint</servlet-class>

  </servlet>

  <servlet-mapping>

  <servlet-name>com.raqsoft.report.view.PagedPrint</servlet-name>

  <url-pattern>/servlet/pagedPrintServer</url-pattern>

  </servlet-mapping>

2.在tag标签中添加serverPagedPrint属性。

<report:html name="report1"

......

serverPagedPrint="yes"

  />

导出 Text 时自定义换行符

 

◆ 背景说明

由于润乾报表中的换行符是固定的，但是WINDOWS下的记事本不支持该换行符。所以在将报表导为Text时，部分字符就会显示成■。为了避免这种情况的发生，润乾报表在tag中定义了textDataLineBreak属性，让用户在导出Text时自定义windows记事本所支持的换行符，从而确保每个字符都能正常显示。

◆ 示例代码

<report:html name="report1"
    ......
     textDataLineBreak="\r\n"
    />